home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / wb / MagicA2024_1_1.lha / MagicA2024 / MagicA2024_engl.doc < prev    next >
Text File  |  1994-11-15  |  5KB  |  182 lines
  1. MagicA2024 1.0 - Documentation
  2. ******************************
  3.  
  4. Copyright
  5. *********
  6.  
  7.    MagicA2024 (C) 1994 kMel, Klaus Melchior
  8.  
  9.    This program is freely distributable, but copyrighted by me. This
  10. means you may freely copy it as long as you do not charge more than a
  11. nominal fee for copying. This program may be put on PD disks,
  12. especially on Fred Fish's CDROMs, AminetCD or other cheap CDROMs. If
  13. you want to distribute this program you MUST keep this document with
  14. it. The program and the documents must be distributed in their original
  15. unmodified form.
  16.  
  17.    This program cannot be used for commercial purposes without written
  18. permission by the author. The author can not be made responsible for
  19. any damage which is caused by using this program.
  20.  
  21.    This program has a GiftWare option. If you like it and use it very
  22. often, you should consider to send a little donation to honor the work
  23. that the author has put into this program.
  24.  
  25.    Send comments, suggestions or bug reports, and the gifts to:
  26.  
  27.      Klaus Melchior, Schulstrasse 17
  28.      D-52156 Monschau, Germany
  29.      Phone: +49 (0)2472 4710
  30.      
  31.      DE:   kmel@eifel.oche.de
  32.      ADSP: kmel@eifel.adsp.sub.org
  33.      DE:   kmel@cwg.fido.de
  34.      FIDO: 2:2452/158.2@fidonet
  35.  
  36. What is MagicA2024 ?
  37. ********************
  38.  
  39.    MagicA2024 is a commodity and patches the private routines of the
  40. icon.library to recolor MagicWB icons to the four A2024 colors. The
  41. bitmap is adjusted on the fly, extra chip memory is needed for the new
  42. image, the blitter is used.
  43.  
  44.    While installing MagicWB or using a remapping tool like MUIReIcon,
  45. the remapped icon is shown, but the original icon is in work. But before
  46. using an icon-editor switch off MagicA2024.
  47.  
  48.    All icons with three or more bitplanes are modified. It's not
  49. possible to recognize non-MagicWB icons.
  50.  
  51.    Two remap routines are implemented, the default one uses the blitter,
  52. check out which one is faster with your configuration.
  53.  
  54.    It can also be used on a standard workbench with normal four-color
  55. palette. Feel free to use it with a workbench which has more than four
  56. colors, even non-MagicWB colors.
  57.  
  58. Arguments
  59. *********
  60.  
  61.    CLI Template: BLANK/S,NOBLITTER/S,CXPRI/K/N,ON/S,OFF/S,REMOVE/S
  62.  
  63. BLANK/S - ToolType: BLANK
  64.      display a blank icon instead of the MagicWB icon <grin>
  65.  
  66. CXPRI/K/N - ToolType: CX_PRIORITY=x
  67.      priority of MagicA2024 commodity
  68.  
  69. OFF/S
  70.      deactivate the already running MagicA2024, now new icons are
  71.      displayed with their original colors
  72.  
  73. ON/S
  74.      switch on the sleeping MagicA2024, new icons are remapped to A2024
  75.      colors
  76.  
  77. NOBLITTER/S - ToolType: NOBLITTER
  78.      a non-blitter routine is used for remapping
  79.  
  80. REMOVE/S
  81.      remove the running MagicA2024 from the commodities list
  82.  
  83. What you need !
  84. ***************
  85.  
  86.    - Kickstart >= 2.0
  87.  
  88.    - Workbench >= 2.0
  89.  
  90.    - A2024 monitor
  91.  
  92.    - MagicWB-Icons
  93.  
  94. How to install
  95. **************
  96.  
  97.    The main directory contains MagicA2024. Copy the "MagicA2024" to a
  98. drawer which contains your utilities.
  99.  
  100.      copy MagicA2024 bin:
  101.  
  102.    To start MagicA2024 automatically you have to insert some lines in
  103. your 's:user-startup'. Like this:
  104.  
  105.      ;BEGIN MAGICA2024
  106.      run >nil: <nil: "bin:MagicA2024"
  107.      ;END MAGICA2024
  108.  
  109.    It's possible to start MagicA2024 within the WBStartup drawer, but
  110. then the recolorization hasn't access on the already opened icons.
  111.  
  112.    PS: It's easier to use the Installer script !!!
  113.  
  114. History of MagicA2024
  115. *********************
  116.  
  117.  
  118.       1.0  15.08.94  * release to aminet & Fred Fish
  119.      
  120.            20.08.94  - didn't work with WB 37.xx, fixed [ubad]
  121.      
  122.            23.08.94  - enforcer hit with one image icons, fixed [ah]
  123.      
  124.            15.11.94  + increase speed of remapping
  125.       1.1            * release to aminet & Fred Fish
  126.  
  127. This is restricted ...
  128. **********************
  129.  
  130.    - Bugs ? I hope not ...
  131.  
  132.    - 2 kiske units: patch private routines of icon.library
  133.  
  134. What is to do in future ?
  135. *************************
  136.  
  137.    - german documentation
  138.  
  139.    - patch routine to remap ToolManager docks
  140.  
  141.    - patch routine to remap WorkBench patterns
  142.  
  143. Thanks are going to ...
  144. ***********************
  145.  
  146.    - Stefan Stuntz [ss] for several tips & testing
  147.  
  148.    - Martin Huttenloher for MagicWB
  149.  
  150.    - Andreas Harrenberg [ah], Gottfried Janik [gj] for testing
  151.  
  152.    - Kai Iske (Mr Patch) for the icon.library hint
  153.  
  154.    - and all I forgot to mention ...
  155.  
  156. Index
  157. *****
  158.  
  159.  
  160.  
  161.  Arguments                              Arguments
  162.  Authors address                        Copyright
  163.  Bug reports                            Copyright
  164.  Bugs                                   Bugs & Limitations
  165.  CLI arguments                          Arguments
  166.  Comments                               Copyright
  167.  Copyright                              Copyright
  168.  Credits                                Credits
  169.  Description                            Description
  170.  Distribution                           Copyright
  171.  E-Mail                                 Copyright
  172.  GiftWare                               Copyright
  173.  History                                History
  174.  Installation                           Installation
  175.  Limitations                            Bugs & Limitations
  176.  MagicA2024                             Description
  177.  Requirements                           Requirements
  178.  Thanks                                 Credits
  179.  ToDo                                   ToDo
  180.  ToolTypes                              Arguments
  181.  
  182.